home *** CD-ROM | disk | FTP | other *** search
/ Best Tools for JAVA / Best Tools for JAVA.iso / JAVA_ALL / IDE / SUBARTIC / SUB_ARCT / INPUT / SIMPLE_D.JAV < prev    next >
Encoding:
Text File  |  1996-10-04  |  2.9 KB  |  73 lines
  1.  
  2. package sub_arctic.input;
  3.  
  4. import sub_arctic.lib.interactor;
  5.  
  6. /** 
  7.  * Input protocol for misc. dragging.  This protocol is designed for generic
  8.  * dragging (i.e., anything not handled by one of the more specifically 
  9.  * targeted drag protocols).  It basically just passes in the various events
  10.  * (which as usual are in the coordinate system of the object they are passed
  11.  * to).  This protocol particularly suitable for dragging components that are
  12.  * inside the object itself (such as the thumb of a slider).
  13.  *
  14.  * @author Scott Hudson
  15.  */
  16. public interface simple_draggable extends focusable, interactor {
  17.  
  18.   /* . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . */
  19.  
  20.   /** 
  21.    * Dispatch the start event of a simple drag.  
  22.    *
  23.    * @param event  evt       the event "causing" the start of the drag 
  24.    *                         (normally a mouse button press).
  25.    * @param Object user_info the uninterpreted user info that was associated
  26.    *                         with this object when it became the drag focus.
  27.    * @return boolean indicating whether the input was consumed.
  28.    */
  29.   public boolean drag_start(event evt, Object user_info);
  30.  
  31.   /* . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . */
  32.  
  33.   /** Dispatch a movement event during a simple drag.  
  34.    *
  35.    * @param event  evt       the event "causing" the the drag (normally a 
  36.    *                         mouse move).
  37.    * @param Object user_info the uninterpreted user info that was associated
  38.    *                         with this object when it became the drag focus.
  39.    * @return boolean indicating whether the input was consumed.
  40.    */
  41.   public boolean drag_feedback(event evt, Object user_info);
  42.  
  43.   /* . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . */
  44.  
  45.   /** Dispatch event corresponding to the end of a simple drag.  
  46.    *
  47.    * @param event  evt       the event "causing" the end of the drag (normally 
  48.    *                         a mouse button release).
  49.    * @param Object user_info the uninterpreted user info that was associated
  50.    *                         with this object when it became the drag focus.
  51.    * @return boolean indicating whether the input was consumed.
  52.    */
  53.   public boolean drag_end(event evt, Object user_info);
  54.  
  55.   /* . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . */
  56. }
  57. /*=========================== COPYRIGHT NOTICE ===========================
  58.  
  59. This file is part of the subArctic user interface toolkit.
  60.  
  61. Copyright (c) 1996 Scott Hudson and Ian Smith
  62. All rights reserved.
  63.  
  64. The subArctic system is freely available for most uses under the terms
  65. and conditions described in 
  66.   http://www.cc.gatech.edu/gvu/ui/sub_arctic/sub_arctic/doc/usage.html 
  67. and appearing in full in the lib/interactor.java source file.
  68.  
  69. The current release and additional information about this software can be 
  70. found starting at: http://www.cc.gatech.edu/gvu/ui/sub_arctic/
  71.  
  72. ========================================================================*/
  73.